╔══════════════════════════════════════════════════════════╗
║     🎬  VIRAL SHORT STUDIO  —  HƯỚNG DẪN cho macOS         ║
╚══════════════════════════════════════════════════════════╝

Phần mềm giống hệt bản Windows — chỉ khác cách CÀI và MỞ.
Cùng một phần mềm chạy được cả Windows lẫn Mac.


────────────────────────────────────────────────────────────
⓪ TẢI PHẦN MỀM VỀ MÁY  (nếu bạn mới có LINK GitHub)
────────────────────────────────────────────────────────────
1. Bạn nhận được file nén VIRAL-SHORT-STUDIO.zip:
     (giải nén file VIRAL-SHORT-STUDIO.zip được gửi kèm)
2. Giải nén file ZIP đó ra một thư mục.
3. Bấm đúp file ZIP trong Downloads để giải nén → ra thư mục
   phần mềm. Kéo thư mục đó ra chỗ dễ tìm (vd Desktop) rồi làm
   tiếp mục ① dưới.


────────────────────────────────────────────────────────────
① MỞ KHOÁ LẦN ĐẦU  (chỉ làm 1 lần, ~30 giây)
────────────────────────────────────────────────────────────
File chép từ Windows sang Mac chưa được phép "bấm đúp".
Làm 1 lần cho phép:

1. Mở TERMINAL:
   • Nhấn  Command (⌘) + phím cách  → gõ:  Terminal  → Enter.

2. Trong Terminal, gõ đúng chữ này (CÓ 1 DẤU CÁCH ở cuối):
        chmod +x

3. KÉO–THẢ cả 3 file "... (Mac).command" từ Finder vào cửa sổ
   Terminal (đường dẫn tự điền vào). Rồi nhấn Enter.

   → Xong. Từ giờ bấm đúp các file được rồi.

   (Nếu Mac báo "không xác minh được nhà phát triển":
    bấm CHUỘT PHẢI vào file → Open → Open.)


────────────────────────────────────────────────────────────
② CÀI ĐẶT  (chỉ làm 1 lần)
────────────────────────────────────────────────────────────
• Bấm đúp:  CÀI ĐẶT (Mac).command

  Nó tự cài: Homebrew, Node.js, FFmpeg, Python, faster-whisper,
  yt-dlp, Claude CLI, lark-cli. Có thể HỎI MẬT KHẨU MÁY của bạn
  (gõ vào, màn hình không hiện ký tự là bình thường) — vài phút.

• Bước cuối mở 2 đăng nhập (làm 1 lần):
    (a) CLAUDE — cần tài khoản Anthropic (cho "bộ não AI").
    (b) LARK  — để đăng video lên Lark Base của BẠN.
  Không dùng cái nào thì gõ  n  rồi Enter để bỏ qua cái đó.


────────────────────────────────────────────────────────────
③ HÀNG NGÀY: MỞ PHẦN MỀM
────────────────────────────────────────────────────────────
• Bấm đúp:  MỞ PHẦN MỀM (Mac).command
  → Trình duyệt tự mở phần mềm tại  http://localhost:5178

• Dùng y hệt bản Windows: tab 🧠 "Cắt tự động" → kéo-thả video
  dài vào → bấm chạy. Tinh chỉnh từng short, tải kèm logo/nhạc/CTA.


────────────────────────────────────────────────────────────
④ TẮT PHẦN MỀM
────────────────────────────────────────────────────────────
• Bấm đúp:  TẮT PHẦN MỀM (Mac).command
  (hoặc nhấn Ctrl+C trong cửa sổ đang chạy server).


────────────────────────────────────────────────────────────
🎤 TÁCH NHẠC — GIỮ VOICE NHÂN VẬT (mới)
────────────────────────────────────────────────────────────
• Ô "🎙️ Giữ giọng, khử tạp âm" có thêm "🎤 Tách nhạc (AI)" →
  bỏ nhạc nền, chỉ giữ tiếng nói. Chưa cài gì vẫn dùng được
  (bộ lọc FFmpeg). Muốn tách sạch: bấm đúp
  "CÀI TÁCH NHẠC (Mac).command" một lần (tải ~2GB).


────────────────────────────────────────────────────────────
PHỤ ĐỀ KHÔNG HIỆN? (lỗi libass)
────────────────────────────────────────────────────────────
• Homebrew đời mới có thể cài ffmpeg THIẾU libass → phụ đề
  không hiện / báo "No such filter: 'ass'".
• Cách sửa: chạy lại "CÀI ĐẶT (Mac).command" — nó tự dò và cài
  bản đầy đủ. Hoặc mở Terminal gõ:
     brew install ffmpeg-full && brew link --overwrite --force ffmpeg-full


────────────────────────────────────────────────────────────
LƯU Ý (Mac)
────────────────────────────────────────────────────────────
• Video xuất ra nằm trong thư mục:  work/out
• Máy Mac KHÔNG có tăng tốc NVIDIA — phần mềm tự chạy bằng CPU
  (chậm hơn Windows có card NVIDIA, nhưng vẫn chạy đủ tính năng).
• Chưa đăng nhập Claude: phần mềm VẪN cắt được theo chế độ dự
  phòng (chia đoạn theo câu nói).
• Gắn thương hiệu + nối Lark: vào tab "⚙️ Cấu hình" trong phần
  mềm (điền tên/lĩnh vực/màu, thư mục ảnh chân dung để làm bìa,
  dán link Lark Base) — không cần đụng file cấu hình.
  Xem chi tiết ở "HƯỚNG DẪN CHUYỂN GIAO.txt" phần ④ và ⑤.
• Không mở được: bấm đúp "MỞ PHẦN MỀM (Mac).command" lại, hoặc
  mở trình duyệt gõ:  http://localhost:5178
